Skip to content

[Reference] field dependent empty_data option description #4083

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Aug 13, 2014

Conversation

xabbuh
Copy link
Member

@xabbuh xabbuh commented Aug 2, 2014

Q A
Doc fix? yes
New docs? no
Applies to all
Fixed tickets #4007
  • choice
  • collection
  • country
  • currency
  • email
  • entity
  • file
  • form
  • integer
  • language
  • locale
  • money
  • number
  • password
  • percent
  • radio
  • search
  • text
  • textarea
  • timezone
  • url

Replacement of #4033.

@xabbuh
Copy link
Member Author

xabbuh commented Aug 2, 2014

I updated #4033 to use a placeholder together with the end-before and start-after options of the include directive.

required and left empty by the user.

The true default value of this option depends on other field options:
DEFAULT_PLACEHOLDER
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we might be able to put a comment above this, to explain its purpose (I'm not sure if the multi-line comment works like this):

.. This file should only be included with start-after or end-before that's set to
   this DEFAULT_PLACEHOLDER value. Its purpose is to let us include only part of this file.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the suggestion. It's really nice. Though we can't use DEFAULT_PLACEHOLDER as is in the comment. But that's not a major issue.

@weaverryan
Copy link
Member

@xabbuh You said this is not yet complete, what else do you want to do? You also said that you're not sure if you like the way it looks now with the default value below the note directive. Where is that?

Thanks!

@xabbuh
Copy link
Member Author

xabbuh commented Aug 7, 2014

You said this is not yet complete, what else do you want to do?

Oh, it's complete now. I forgot to remove that note.

You also said that you're not sure if you like the way it looks now with the default value below the note directive. Where is that?

That was before I introduced the placeholder. The description of the real default value was that split with an example of when this might be useful. Now, we have the description of the default value first, followed by the example. I think it's fine this way.

@weaverryan
Copy link
Member

Ok, let's see if this renders how we expect :). Thanks Christian!

@weaverryan weaverryan merged commit 6b61260 into symfony:2.3 Aug 13, 2014
weaverryan added a commit that referenced this pull request Aug 13, 2014
…xabbuh)

This PR was merged into the 2.3 branch.

Discussion
----------

[Reference] field dependent empty_data option description

| Q             | A
| ------------- | ---
| Doc fix?      | yes
| New docs?     | no
| Applies to    | all
| Fixed tickets | #4007

- [x] choice
- [x] collection
- [x] country
- [x] currency
- [x] email
- [x] entity
- [x] file
- [x] form
- [x] integer
- [x] language
- [x] locale
- [x] money
- [x] number
- [x] password
- [x] percent
- [x] radio
- [x] search
- [x] text
- [x] textarea
- [x] timezone
- [x] url

Replacement of #4033.

Commits
-------

6b61260 field dependent empty_data option description
@xabbuh
Copy link
Member Author

xabbuh commented Aug 13, 2014

Thanks, Ryan! I think it looks good so far.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants